home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / sbbshslk.zip / DSZ2ICOM.ZIP / DSZ2ICOM.DOC next >
Text File  |  1992-02-18  |  10KB  |  182 lines
  1.  
  2. ==============================================================================
  3.                                    DSZ2ICOM
  4.                              Martin Schnitkemper
  5.                                  Postbox 7462
  6.                                 W-4400 Münster
  7. ==============================================================================
  8.  
  9.  
  10. Introduction:
  11. ------------
  12. This application is designed to run under QuickBBS or a compatible system like
  13. RemoteAccess  or even SuperBBS in conjunction with a filetransfer manager like
  14. EFT.  It is running  under MS-DOS v5.00_D, SuperBBS  v1.16 beta-1, EFT v1.21ßb
  15. and the HS/Link protocol v1.01.
  16.  
  17.  
  18. The Problem:
  19. -----------
  20. Usualy  the  most filetransfer  manager can  only  handle either  an up-  or a
  21. download  and get confused with any  bidirectional protocol like BiModem. Erik
  22. Labs  created a new  logformat, named the  "Intercommunication Logfile" and it
  23. seems  to be that this format becomes standard for bidirectional protocols. If
  24. you  are one of the lucky  guys who used EFT (not  only for this reason), this
  25. filetransfer manager support the usage of the intercom logfile. Unfortunately,
  26. at this moment only BiModem creates this intercom logfile and can only used as
  27. an realy bidirectional transfer protocol.
  28. The recently released new transferprotocol HS/Link is a bidirectional protocol
  29. but  does only create a DSZ logfile.  If you install this protocol, you either
  30. lost the account of the up- or the download, depending of the direction.
  31. But don't worry, here comes...
  32.  
  33.  
  34. The Solution:
  35. ------------
  36. After  the filetransfer,  DSZ2ICOM reads the  logfile, created  by HS/Link and
  37. writes  a new file out  named "INTERCOM.LOG". This file  is full compatible to
  38. the BiModem standard. For the structure of this file, please refer the BiModem
  39. documentations.  All fields of the DSZ logfile will be converted into the ICOM
  40. style.  Unsupported fields will  be remainded empty,  the time- and datefields
  41. contains the current values.
  42.  
  43.  
  44. The Installation:
  45. ----------------
  46. The  installation  is quite  easy,  if you  use  already the  EFT filetransfer
  47. manager. Please add additional lines like the example
  48. shown below:
  49.  
  50. ;
  51. Protocol     98         H      U   64            HS/Link
  52. INTERCOMM DSZ2ICOM HSLINK -P$1 -B19200 -E$2 -HX -S4096 -K -R -O
  53. behaviour getinfos arctest resume
  54.  
  55. Protocol     98         H      D   64            HS/Link
  56. INTERCOMM DSZ2ICOM HSLINK -P$1 -B19200 -E$2 -HX -S4096 $3 -K -UF:\UPLOADS
  57. behaviour arctest leaveuploads
  58. ;
  59.  
  60. Use  the INTERCOMM protocol statement instead of DSZ. To get full control over
  61. the  HS/Link protocol depending on the transfer direction, use the commandline
  62. parameters.   Most of  them are optional,  read the HS/Link  manual for a full
  63. description. I got the best results after erasing HSLINK.CFG.
  64.  
  65. Don't  ask  me  for other  examples  as  I would'nt  never  change  to another
  66. filetransfer manager than EFT ...
  67.  
  68. You should know:
  69. ---------------
  70.  
  71.  
  72. Specify  the upload path  on the commandline only  on downloads. Don't specify
  73. this  path with HSCONFIG  (you better omit the  whole configuration file), let
  74. EFT determine the path on uploads!
  75.  
  76. An  upload, coming together with  users download will be  placed in this path.
  77. Don't  include this path  in your FLSEARCH  files, use a  common one (i.e. the
  78. same as you use with BiModem). In this mode an aborted upload can't recover by
  79. the  user, the remaining  part will be  moved by EFT  to your crash directory.
  80. (Enable with the -K switch).
  81.  
  82. The  upload mode gives the user the opportunity to finish a broken upload. EFT
  83. will move the upload to the current area after completion. (Enable with the -K
  84. -R and -O switches).
  85.  
  86. Set  the DSZLOG  environment variable.  Without it  HS/Link does  not create a
  87. logfile.  I recommend  to set it  to "DSZ.LOG", without  a path specification.
  88. DSZ2ICOM  create INTERCOMM.LOG  as the   logfile. EFT  does  accept  it as the
  89. default, do not set it to another name.
  90.  
  91. DSZ2ICOM  IS FREEWARE: I  hereby declare the whole  material as public domain,
  92. nor  charge or fee maybe given to me  or anyone else for this application. Use
  93. it on your own risk so long as you want. Give it away to everyone who need it.
  94.  
  95. DSZ2ICOM  is  a  subset  of SBiLink,  the  bidirectional  protocol  driver for
  96. SuperBBS systems.
  97.  
  98.  
  99. Revision History:
  100. ----------------
  101. 18.02.92 v0.09    ■ Since  HS/Link v1.01  returns  related log  entries after
  102.                     aborted  transfers, I  removed the  detection from coding.
  103.                     NOTE:  This version of  DSZ2ICOM does no  longer work with
  104.                     releases  of  HS/Link previous  to v1.01,  so you  have to
  105.                     upgrade now!
  106.                   ■ The history  file is  no longer  written. Non  (are there
  107.                     still  any?) EFT users: DSZ.LOG  will remain for debugging
  108.                     reasons until the next session of DSZ2ICOM starts.
  109.                   ■ Filename in INTERCOM.LOG had trailing spaces. Terminating
  110.                     now with a binary zero (ASCIZ).
  111.                   ■  HS/Link  can't   pass  a   file  description,   set  the
  112.                     corresponding  field  in  the  INTERCOM.LOG  today  to  80
  113.                     spaces.
  114.                   ■ HS/Link v1.01 returns now a cps of 9999 if a received file
  115.                     already   exist   in   the  same   subdirectory   and  the
  116.                     verification did not failed. In this case DSZ2ICOM set the
  117.                     status  to "D"  to indicate  a duplicate  upload. It seems
  118.                     that you can specify now the -K, -O, -R and -U switches in
  119.                     both ways without problems.
  120. 17.01.92 v0.08    ■ Runtime error occured while searching for existing files.
  121.                     Changed the procedure, hope to fix this bug.
  122.  
  123. 09.01.92 v0.07    ■ Improved  again  the handling  of  aborted  transfers, it
  124.                     should  now work correctly if  you follow the instructions
  125.                     and examples, mentioned above. DSZ2ICOM determines now the
  126.                     transfer  direction in to  steps: On uploads  it scans the
  127.                     current directory for the aborted file. If it is there, it
  128.                     must be an aborted received file, if not it was an attempt
  129.                     to  send.  On  downloads  it  scans  in  the  given upload
  130.                     directory.  For this reason you have  to use the -U switch
  131.                     to  tell  HS/Link  (and even  DSZ2ICOM)  the  upload path.
  132.                     Define the upload path no longer with HSCONFIG.
  133.                   ■ The direction of an aborted transfer will be indicated by
  134.                     a  single letter  in brackets  as a  local message  on the
  135.                     screen.
  136.                   ■ If  another DSZ.LOG  or INTERCOM.LOG  is present  on your
  137.                     system  and a  previously issued append  command points to
  138.                     these  paths, unfortunately  these files  will be updated.
  139.                     For  this reason, both files will  be truncated to a null-
  140.                     length-entry  before  and after  DSZ2ICOM  is/was invoked.
  141.                     Anyway, you are on the safe side if you hold no duplicates
  142.                     of these files on your system.
  143. 05.01.92 v0.06    ■ I got it! To detect the direction of an aborted transfer,
  144.                     DSZ2ICOM  extract now the upload path from the commandline
  145.                     and  compare it with the  filespecification, given via the
  146.                     DSZ.LOG file. If it is equal, the entry will be treated as
  147.                     a received file, otherwise as a sent one. Note: For proper
  148.                     operation  you  *must*  now  use  the  -U  switch  on  the
  149.                     commandline,  either if  you defined the  upload path with
  150.                     HS-CONFIG  or  not.  Dear  Mr.  Smith:  Create  a  DSZ.LOG
  151.                     according to the given standard, thanx!
  152.                   ■ I  changed  the  FileID  of  the  history  file  today to
  153.                     "DSZ2ICOM.LOG" due to a buggy GSZ proto driver who updated
  154.                     the first (and probably wrong) DSZ.LOG file.
  155.                   ■  Reading   now   the  DSZLOG   environment   variable  to
  156.                     locate/create the DSZ logfile. If the variable is missing,
  157.                     DSZ2ICOM assume the DSZ.LOG in the current directory and a
  158.                     warning will be issued.
  159.  
  160. 04.01.92 v0.05    ■ Got still problems with aborted transfers: HS/Link is not
  161.                     able  to  differ between  sent or  received files  after a
  162.                     carrier  loss  or  an  abort.  Regardless  the  direction,
  163.                     HS/Link  indicates all  aborted transfers  in DSZ.LOG with
  164.                     capital  letters. Following the usual logic, these entries
  165.                     must  be treated as received files.  Due to the problem of
  166.                     handling, an entry in the intercomm logfile will no longer
  167.                     be  created in  case of  aborted transfers.  Hope to solve
  168.                     this  problem now. Remeber: You  can still  resume aborted
  169.                     uploads,   using  the  -O   (overwrite)  and  -R  (resume)
  170.                     switches.
  171.                   ■ Fixed a bug  in the cps calculation:  A reported cps over
  172.                     3200  bps (unusual,  but possible  after resumption  of an
  173.                     aborted transfer) will be set to a zero value.
  174.  
  175. 03.01.92 v0.04    ■ Kept the first and last two lines of the screen unchanged
  176.                     to display EFT's informations
  177.                   ■ Creating a  DSZ.LOG   history file  at the  root path for
  178.                     debugging reasons
  179.                   ■ Fixed a bug, handling aborted transfers
  180.  
  181. 16.12.91 v0.03    ■ First release to selected sysops only
  182.